home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 4 / Mac Giga-ROM 4.0 - 1993.toast / FILES / COM / A-H / GEnieRefmt221.cpt / GenieRefmt 2.2.1 Info next >
Text File  |  1991-01-29  |  8KB  |  174 lines
  1.  GEnie Reformatter v2.2.1 Documentation
  2.  ======================================
  3.  
  4. Please distribute this text document along with the GEnie Reformatter,
  5. when you pass it along to your friends and associates.
  6.  
  7. This favorite utility quickly reformats a GEnie file listing, from two
  8. lines of text per file, into one line of text per file. This enables
  9. you to load the file listing into your database program of choice,
  10. whereupon you can sort and search to your heart's content, using the
  11. powerful features of your database program, and without burning up
  12. connect time doing it. You may specify which fields are to be copied,
  13. how to separate them, and the creator signature of the output file.
  14. Your preferences are remembered between uses.
  15.  
  16. Just for the record (I've had people ask), I use OverVUE to manipulate
  17. the reformatted file lists.  It's really fast!  And no, I haven't
  18. upgraded to Panorama — I'm waiting to accumulate enough registration
  19. fees to be able to afford it!
  20.  
  21.  Registration Info
  22.  =================
  23.  
  24. This program is distributed as SHAREWARE!  It is not free, or public
  25. domain.  You must pay a user registration fee of $5.00 in order to
  26. legally keep and use this program!
  27.  
  28. I am trying to avoid the hassle and expense of commercial advertising
  29. and distribution, by making this program available through the
  30. shareware “try before you buy” route.
  31.  
  32. Please note the three (3) day trial period. There's nothing
  33. complicated about this very popular and useful utility, no tricky
  34. features it would take time to master. You should know immediately
  35. whether you'd rather send the money, or trash the program.
  36.  
  37. To register your copy of GEnie Reformatter, send your check or money
  38. order for $5.00 to:
  39.  
  40.      SK Hushing III (GEnie Reformatter 2.2.1)
  41.      PO Box 9745
  42.      San Diego, California 92169
  43.  
  44. Your cancelled check will be your proof of registration.
  45.  
  46. Thanks in advance for showing the consideration and honesty to become
  47. a registered user.
  48.  
  49.  License Agreement
  50.  =================
  51.  
  52. Please read the following license agreement carefully.
  53.  
  54. This program is distributed as Shareware.  It is NOT "Free" or "Public
  55. Domain". You are hereby licensed and encouraged to give this program
  56. to others at no charge. You may not sell it, charge for distributing
  57. it, or distribute it along with a product you sell, without my written
  58. permission.  You must not modify the program or screens in any way.
  59.  
  60. The title, contents, cover, and manner of presentation are fully
  61. protected under the laws of the United States. Copying, decompilation,
  62. or reproduction, except in accordance with the policy stated herein,
  63. is forbidden without the written permission of SK Hushing III.
  64.  
  65. The program is provided "as is", without warranty of any kind.  You
  66. assume the entire risk as to the results and performance of the
  67. program.  SK Hushing III will not be responsible for, and will be
  68. indemnified against, any loss or expense arising from the User's use
  69. of the information (including claims and suits for libel) derived from
  70. the application of this program, without limitation.
  71.  
  72. In addition, no guarantee or warranty of application is expressed or
  73. implied for this program or any parameters derived therefrom,
  74. including, but not limited to, errors and omissions, implied
  75. warranties of merchantability, and fitness for a particular purpose.
  76.  
  77. In no event shall SK Hushing III be liable for any damages whatsoever
  78. (including, without limitation, damages for loss of business profits,
  79. business interruption, loss of business information, and the like)
  80. arising out of the use of or inability to use this program, even if
  81. SK Hushing III has been advised of the possibility of such damages.
  82.  
  83. Implied warranty is limited to the direct cost and not for any
  84. indirect or subsequent damage due to loss of business or profits. The
  85. User or User's agent(s) assume all risk and liability without
  86. limitation.
  87.  
  88. These terms and conditions shall be construed and governed in
  89. accordance with the laws of the State of California.
  90.  
  91. IF YOU KEEP AND USE THIS PROGRAM, THEN YOU ARE AGREEING TO ABIDE BY
  92. THE TERMS OF THE LICENSE AGREEMENT AS STATED ABOVE.
  93.  
  94.  Update Policy
  95.  =============
  96.  
  97. A note to registered users of GEnie Reformatter versions 2.0, 2.1,
  98. 2.1.1, and 2.2 --> Thank you for your support!  You may consider
  99. yourself registered users of version 2.2.1 also, without any
  100. additional registration fee.
  101.  
  102. Sorry, but the registration fee is too low for me to mail out updates.
  103.  
  104.  Usage Hints
  105.  ===========
  106.  
  107. • First, create the file to be reformatted:  While on GEnie at the
  108. prompt for the software library of your choice, start your terminal
  109. program capturing to a text file, then ask for a GEnie file listing.
  110. At press time, this would be item 2, 3, or 11 on the Software Library
  111. menu. Don't worry about any extraneous text in the captured file.
  112. GEnie Reformatter ignores any lines that don't match a special
  113. template. Once you've captured all the file listings you want, stop
  114. capturing to the text file. Continue with your GEnie session, etc.
  115. After you've logged out, then…
  116.  
  117. • Run the GEnie Reformatter. After the introductory window comes up
  118. (have you sent your $5.00 yet?), click in the window to make it go
  119. away.
  120.  
  121. • Next select "Preferences…" from the File menu, and select your
  122. preferences. I usually have it copy the file number, name, date, size,
  123. and description, with tabs for delimiters, and EDIT for the output
  124. file creator.  BBS SysOps have a special flag available to them on the
  125. file listing, and they can set it up so that the SysOp flag appears
  126. either before or after the file number field. The preferences will
  127. remain set that way until you set them again.
  128.  
  129. • Next select "Open and Reformat…" from the File menu, and select a
  130. file to reformat. GEnie Reformatter will create an output file by
  131. appending “.FMT” to the input file name, then will copy the file with
  132. the reformatting options you specified.  If you want to reformat
  133. several files, just repeat this step until you're done.  Use of the
  134. command-o keyboard equivalent will speed up the process slightly.
  135.  
  136.  Version Information (latest version first)
  137.  ==========================================
  138.  
  139. Version 2.2.1 fixed a bug which caused the wrong fields to be copied
  140. under certain conditions.
  141.  
  142. Version 2.2 recognized files with a 1991 upload date.  It also allowed
  143. you to create an output file with columns of data separated only by
  144. spaces (file type SDF for you Foxbase users).
  145.  
  146. Version 2.1.1 recognized files with a 1990 upload date, and used a
  147. slightly faster method of testing each record against the template.
  148.  
  149. Version 2.1 stripped leading and trailing spaces from each field, for
  150. a smaller database, and was the first version to remember preferences!
  151.  
  152. Version 2.0 was a LightSpeed™ C rewrite for speed — in fact, it was
  153. about an order of magnitude faster, and it also allowed you to specify
  154. your preferences for the reformatting. Roughly ten times faster, and
  155. one third the size, with more features. Not bad.
  156.  
  157. Version 1.0 was written in Microsoft BASIC, and automatically copied
  158. the file number, name, date, size, and description to the output file.
  159. Even though it was compiled, it was pretty slow, due to heavy use of
  160. the BASIC string functions which are none too quick. For what it did,
  161. the application size was pretty large, too. Blame the BASIC runtime
  162. library for that.
  163.  
  164.  Support
  165.  =======
  166.  
  167. If you have questions, or suggestions, or <gasp!> find a bug, please
  168. let me know. A note enclosed with your registration payment is most
  169. likely to get my attention.
  170.  
  171. Otherwise, my GEnie mail address is SHUSHING.
  172.  
  173. Speaking of support, thank you in advance for yours!
  174.